docs: Move GdkEvent docs inline

This is not really worth a chapter of its own.

diff --git a/docs/reference/gdk/events.md b/docs/reference/gdk/events.md
deleted file mode 100644 (file)
index 9925c1d..0000000
--- a/docs/reference/gdk/events.md
+++ /dev/null
@@ -1,10 +0,0 @@
-Title: Events
-
-## Handling events from the window system
-
-In GTK applications the events are handled automatically by toplevel
-widgets and passed on to the event controllers of appropriate widgets,
-so using [class@Gdk.Event] and its related API is rarely needed.
-
-[class@Gdk.Event] and its derived types are immutable data structures,
-created by GTK itself to represent windowing system events.

diff --git a/docs/reference/gdk/gdk4.toml.in b/docs/reference/gdk/gdk4.toml.in
index bbb08ba0e97e063eb2670b8211467917c83c9864..887fac11600c1fe172d730fe2c06965df2fd7cdd 100644 (file)
--- a/docs/reference/gdk/gdk4.toml.in
+++ b/docs/reference/gdk/gdk4.toml.in
@@ -34,7 +34,6 @@ base_url = "https://gitlab.gnome.org/GNOME/gtk/-/blob/master/"
 
 [extra]
 content_files = [
-  "events.md",
   "keys.md",
   "cairo.md",
   "pango.md",

diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index 43692c4f9500b930c893c32d3e025e60dca59446..c4548aa22759552586048631df22f3f3421f19c3 100644 (file)
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -41,8 +41,12 @@
 /**
  * GdkEvent: (ref-func gdk_event_ref) (unref-func gdk_event_unref)
  *
- * The GdkEvent struct contains only private fields and
- * should not be accessed directly.
+ * `GdkEvent` and its derived types are immutable data structures,
+ * created by GTK itself to represent windowing system events.
+ *
+ * In GTK applications the events are handled automatically by toplevel
+ * widgets and passed on to the event controllers of appropriate widgets,
+ * so using `GdkEvent` and its related API is rarely needed.
  */
 
 /**